공통 옵션 설명
이 모듈은 20260507 이후 버전에서 사용할 수 있습니다.
여러 ui_element 인터페이스가 옵션 테이블을 받으며, 대상 App, 반환 수, 재귀 깊이, 히트 검증 및 스크롤 단계 값을 지정하는 데 사용합니다.
조회 옵션
local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
- pid
정수. 대상 App의 프로세스 식별자를 지정합니다. 전달하지 않으면 일반적으로 포그라운드 App을 사용합니다. - max_level
정수. 하위 요소의 재귀 깊이입니다. 반환 데이터 양을 제어할 때 보통1또는2를 사용합니다. - max_elements
정수. 반환할 최상위 요소의 최대 수입니다. - fallback_children
불리언. 일반 목록이 비어 있으면 하위 요소 읽기를 시도합니다. 기본값은 인터페이스마다 다릅니다. - include_hit_state
불리언. 히트 상태 필드를 추가할지 여부입니다. - hit_test
불리언. 화면 샘플링 히트를 사용할지 여부입니다. 일반 스크립트에서는 보통 사용할 필요가 없습니다. - fallback_hit_test
불리언. 일반 목록이 비어 있으면 화면 샘플링 히트를 시도할지 여부입니다. - hit_test_spacing
숫자. 화면 샘플링 간격이며 단위는 논리 좌표입니다. 기본값은40입니다.
속성 제외 옵션
20261115 버전부터 사용 가능. snapshot()과 list_text_elements()에만 사용합니다. 모두 불리언이며 기본값은 false이고 자식 요소에도 적용됩니다. 해당 상태가 필요하지 않다면 제외 옵션을 켜서 조회 비용을 줄이고 스냅샷을 더 빠르게 가져올 수 있습니다.
- exclude_visibility
true이면 가시성 조회를 건너뛰고isVisible을 생략합니다. - exclude_map
true이면 지도 속성 검사를 건너뛰고isMap을 생략합니다. 지도 요소 자체는 유지됩니다. - exclude_hit_state
true이면 중심점 히트 검사를 건너뛰고canHit,hitVerified,hitTestPoint,hitTestPointLogical을 생략합니다.include_hit_state = true와 함께 사용할 수 없습니다.
요소 범위, 텍스트, 좌표 및 hit_test / fallback_hit_test의 요소 보충 규칙은 바뀌지 않습니다. 상태를 기준으로 필터링해야 한다면 해당 필드를 제외하지 마세요.
동작 옵션
- point
테이블. 스크롤 또는 히트에 사용할 좌표점을 지정하며 단위는 물리 픽셀입니다. 예:{ x = 200, y = 700 }. - x / y
정수.point와 같으며 옵션 테이블에 직접 넣을 수 있습니다. - steps
숫자. 스크롤, 증가 또는 감소 작업에 사용할 단계 인수입니다. 구체적인 효과는 대상 컨트롤에 따라 다릅니다.
설명
list_text_elements()는 이전 스크립트와의 호환성을 위해 기본 동작이 더 보수적입니다.find(),find_all(),snapshot()과 동작 인터페이스는 새 스크립트에서 직접 사용하기에 더 적합합니다.hit_test는 현재 최상위 화면에 더 가까운 요소를 반환할 수 있지만 비용이 더 높으므로, 일반 조회로 요소를 가져올 수 없을 때만 사용하는 것이 좋습니다.